docs: cover pre-2026.6 automation, helper, dashboard & scene gaps#59
docs: cover pre-2026.6 automation, helper, dashboard & scene gaps#59kingpanther13 wants to merge 1 commit into
Conversation
There was a problem hiding this comment.
Code Review
This pull request introduces comprehensive updates to the Home Assistant best practices documentation, including a new reference guide for Scenes (scenes.md) and extensive additions to the automation patterns, dashboard guide, and helper selection references. The reviewer's feedback focuses on optimizing token-efficiency for LLMs by suggesting that bulleted lists in helper-selection.md, scenes.md, and dashboard-guide.md be converted into comma-separated paragraphs.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
cd90a0c to
b20c2ca
Compare
Fills coverage gaps that predate 2026.6 (issue homeassistant-ai#50): automation-patterns.md - Trigger Types: zone, template, calendar, webhook, homeassistant, conversation, tag, geo_location, persistent_notification triggers; fire-an-event action note - Native Conditions: trigger condition; device-condition caveat note - New sections: Parallel Actions (vs mode: parallel), Stopping a Sequence (stop:), Variables (+ trigger_variables caveat), Capturing Action Responses (response_variable); delay: action; per-element enabled: helper-selection.md - trend, bayesian (new Probabilistic Inference section), mold_indicator - 'How Helpers Are Created': storage-collection vs config-entry-flow classification (HA mechanisms, no tool names) - TOC + decision-matrix rows dashboard-guide.md - Dashboard Strategies (+ 'Take control'); heading card; markdown card; grid_options card sizing; expanded visibility conditions (screen, etc.); typed entity/object badge form; drop stale (2024+) heading qualifier references/scenes.md (new) - Scene config shape, turn_on/create/apply/reload, snapshot-vs-script - SKILL.md Reference Files + README Skill Contents updated Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
b20c2ca to
1d74397
Compare
|
@sergeykad sorry I forgot to mark these as ready, both this one and #60 are ready for review. |
What does this PR do?
Fills coverage gaps in the
home-assistant-best-practicesskill that predate HA 2026.6 — native constructs that have existed for releases but the skill never documented. Closes #50, and folds in additional verified gaps found while auditing the referenced files.references/automation-patterns.mdzone,template,calendar,webhook,homeassistant,conversation,tag,geo_location,persistent_notificationtriggers; a "fire an event" action note paired with the event triggercondition: trigger; acondition: devicecaveat on the device triggerparallel:vsmode: parallel), Stopping a Sequence (stop:), Variables (variables:/trigger_variables:), Capturing Action Responses (response_variable); adelay:action entry; per-elementenabled:references/helper-selection.mdtrend,bayesian(new Probabilistic Inference section), andmold_indicatorhelpers (+ TOC and decision-matrix rows)references/dashboard-guide.mdgrid_optionscard sizing; heading card; markdown card; object/typed badge form; expanded visibility conditions (incl.screen); dropped the stale(2024+)heading qualifierreferences/scenes.md(new)scene.turn_on/create/apply/reload, and the snapshot-vs-script distinction; wired intoSKILL.mdandREADME.mdEvery added snippet was verified against the current home-assistant.io docs and, where relevant, home-assistant/core source (multi-agent adversarial review). Tool-agnostic throughout — no MCP tool names — per CONTRIBUTING.
Checklist
README.mdSkill Contents table updated (if reference files were added or removed) — addedreferences/scenes.md🤖 Generated with Claude Code